home *** CD-ROM | disk | FTP | other *** search
/ Deutsche Edition 2 / Deutsche Edition 2.iso / mac / TEXT / OzTeX 1.7 ƒ / readme17 < prev    next >
Text File  |  1994-07-29  |  7KB  |  150 lines
  1. Installation notes for OzTeX 1.7
  2. ================================
  3. Andrew Trevorrow, May 1994
  4.  
  5. OzTeX is a shareware implementation of TeX for the Macintosh.
  6. This file explains how to install OzTeX and print out a copy of the
  7. OzTeX User Guide.  OzTeX is normally distributed as a set of hqx files.
  8. (Current users of OzTeX 1.6 should note that no new PK files have been
  9. added to the distribution, so you don't need any of the pk*.hqx files.)
  10. After decoding the hqx files you should have the following set of
  11. StuffIt archives:
  12.  
  13. oztex.sit   -- Contains the OzTeX and OzTools applications, and these
  14.                folders: Configs, Help-files, TeX-docs, LaTeX-docs,
  15.                BBEdit Lite and PK-files (initially empty).
  16. oz68000.sit -- Contains OzTeX and OzTools for Macs with 68000 CPUs.
  17. fonts.sit   -- Contains the TeX-fonts, VF-files and PS-files folders.
  18. inputs.sit  -- Contains the TeX-inputs folder.
  19. formats.sit -- Contains the TeX-formats folder.
  20. pk*.sit     -- Contain PK files in various folders (these folders
  21.                must be moved into the PK-files folder).
  22.  
  23. Note that StuffIt Expander will unpack some hqx files into new folders
  24. (eg. "fonts Folder"), so you'll have to take everything out of these 
  25. folders and throw away the empty folders.
  26.  
  27. The PK files supplied with OzTeX support 300 and 360 dpi printers.
  28. OzTeX can scale PK fonts on printers that don't match these resolutions,
  29. but for best results you should try to get a matching set of PK files.
  30. For example, if you have an ImageWriter then you should get a set of
  31. 144 dpi PK files by anonymous ftp from midway.uchicago.edu in
  32. pub/tex/macintosh/dvi2img.
  33.  
  34. How to install OzTeX
  35. --------------------
  36. If you already have an earlier version of OzTeX then you should install
  37. this new version in a new folder to avoid clobbering any of your own
  38. fonts, config files, TeX input files, etc.  Once you have the new version
  39. up and running it should be easy to merge in your modifications.
  40. Assuming you have enough disk space, carry out the following steps:
  41.  
  42. 1. Create an empty folder on your hard disk and call it anything you like.
  43.  
  44. 2. Use StuffIt or UnStuffIt to unpack all the *.sit files into this folder.
  45.    When everything is unpacked, all the files and folders listed earlier
  46.    must be in the same folder as the OzTeX application.
  47.  
  48. 3. Move all the PK sub-folders (300, 329, etc) into the PK-files folder.
  49.    (Skip this step if you already have a version of OzTeX.)
  50.  
  51. OzTeX should now be ready to run.
  52.  
  53. How to print the OzTeX User Guide
  54. ---------------------------------
  55. 1. Start up OzTeX by double-clicking on the application.  It should load
  56.    the Default configuration file stored in the Configs folder.
  57.    If you get any warning messages about unknown folders or files then
  58.    you've made a mistake in the above installation.
  59.  
  60. 2. OzTeX is set up to print on A4 paper.  If your printer uses US Letter
  61.    paper then select "US Letter" from the Config menu.
  62.  
  63. 3. If you are using a non-PostScript printer then select "Page Setup..."
  64.    from the File menu and check that the paper size and orientation
  65.    are correct.
  66.  
  67. 4. If you are using a StyleWriter (or some other 360 dpi printer) then
  68.    select the "StyleWriter" item in the Config menu.
  69.  
  70. 5. Select "Print DVI..." from the File menu and open ozuser.dvi in the
  71.    LaTeX-docs folder.
  72.  
  73. 6. When the print dialog box appears, select suitable options (you might
  74.    want to reverse the page order if your printer stacks pages face up)
  75.    and click on the Print button.
  76.  
  77. Once the User Guide is printed you might like to read it!
  78. Users of OzTeX 1.6 should note that the following sections have been
  79. added or substantially revised:
  80.  
  81. - Choosing an editor
  82. - Setting the default view
  83. - Continuing from where you left off
  84. - The Edit menu
  85. - The Config menu
  86. - LaTeX or LaTeX2e?
  87. - Building big formats
  88. - Creating new TFM files
  89. - PostScript fonts
  90. - Compatibility with other DVI drivers
  91. - Rotating TeX material
  92.  
  93. Users of OzTeX 1.6 can also see what's new in version 1.7 by selecting
  94. "Changes to OzTeX 1.6" in OzTeX's Help menu.  There are a number of
  95. important changes; in particular, EPSF \specials in old DVI files
  96. may not be printed or previewed in the same location in OzTeX 1.7,
  97. so you should regenerate all DVI files that contain such \specials.
  98.  
  99. Choosing an editor
  100. ------------------
  101. OzTeX does not contain an integrated text editor.  Instead, Rich Siegel's
  102. BBEdit Lite is supplied.  The BBEdit Lite folder contains the application
  103. and its documentation.  You might prefer to use another editor.
  104. Pete Keleher's Alpha is a popular editor for TeX/LaTeX input files.
  105. I decided to distribute BBEdit Lite because it is free, much smaller
  106. than Alpha, and does not require System 7.
  107.  
  108. Nearly all the text files distributed with OzTeX are created by MPW
  109. (that's the editor I prefer to use).  Note that BBEdit Lite comes with a
  110. small application called TextChanger which lets you change the creator of
  111. all text files to whatever application you like.
  112.  
  113. If you are using System 7 then one of the first things you should do
  114. after starting up OzTeX is select "Choose Editor" from the Edit menu.
  115. Use the standard file dialog to select the application you'll be using
  116. to edit your TeX/LaTeX input files.  If the application can receive Apple
  117. events then OzTeX will remember its name and location for later use.
  118.  
  119. A minimal OzTeX system
  120. ----------------------
  121. You may be running short of space on your hard disk, so let's consider the
  122. bare essentials needed for a working OzTeX system (before deleting any files
  123. it would be a good idea to save the complete OzTeX distribution on floppies):
  124.  
  125. - You won't need both sets of OzTeX and OzTools in oztex.sit and oz68000.sit.
  126.   Try the applications in oztex.sit first; if they start up then delete the
  127.   68000 versions.
  128. - If you won't be creating any TFM or VF files then delete OzTools.
  129. - TeX-docs and LaTeX-docs contain important documentation and example files,
  130.   so don't remove any files from these folders until you've had a look at them.
  131. - The Help-files folder can be removed after reading the help files.
  132. - If you don't want to use LaTeX2e, delete the *2e sub-folders in TeX-inputs.
  133. - If you don't use LaTeX, delete the LaTeX sub-folder in TeX-inputs.
  134. - Delete any format files that you don't intend using from the TeX-formats
  135.   folder.  Don't delete TeX.pool though; it's needed by INITEX.
  136. - If you won't be using PostScript fonts then delete all files in the VF-files
  137.   folder and delete the PS sub-folder in TeX-fonts.
  138. - The BBEdit Lite folder can be deleted if you use a different text editor.
  139.  
  140. The best way to save disk space is to unpack all the PK files on to a set of
  141. floppies and only install individual files on your hard disk when you discover
  142. you actually need them.  When viewing a DVI file, use "Page Info" in the View
  143. menu to display a list of all the fonts used in the document.  If any PK file
  144. is marked "DOES NOT EXIST" then copy it from a floppy into the appropriate
  145. sub-folder in PK-files.  Note however that a missing PK file may not be
  146. supplied with OzTeX, especially if you asked for an unusual magnification.
  147. In that case you'll need to get the PK file from some other source (by ftp
  148. from some TeX archive) or build it yourself using one of the Metafont
  149. implementations mentioned in the "Related Software" help file.
  150.